Метод IServices::GetSingleItemByID

Возвращает ссылку на объект сервиса по его идентификатору.

IDL

[id(103507)]
HRESULT GetSingleItemByID(
    [in] BSTR ServiceID, 
    [out, retval] IService** Value
);

Параметры

Параметры	Описание
ServiceID	Идентификатор сервиса
Value	Возвращаемое значение

Возвращаемое значение

Ссылка на объект сервиса.

Описание

Метод выполняет поиск экземпляра сервиса с указанным идентификатором среди закэшированных сервисов, созданных методами IServices::GetSingleItemByID или IServices::GetSingleItemByUSI.

Если сервис найден, то метод возвращает ссылку на найденный экземпляр сервиса.

Если сервис не найден, то метод создает экземпляр сервиса, кэширует его и возвращает ссылку на него .

Метод возвращает ссылку на объект сервиса.

Требования

№	Описание
1.	Сервис c указанным идентификатором должен существовать.

Смотрите также

IServices::GetSingleItemByUSI